table of contents
READDIR(3) | Manual del Programador de Linux | READDIR(3) |
NOMBRE¶
readdir - lee un directorio
SINOPSIS¶
#include <sys/types.h> #include <dirent.h> struct dirent *readdir(DIR *dir);
DESCRIPCIÓN¶
La función readdir() devuelve un puntero a una estructura dirent que representa la siguiente entrada de directorio en el flujo de directorio al que apunte dir. Devuelve NULL cuando alcanza el fin-de-fichero o si hay un error.
Según POSIX, la estructura dirent contiene un campo char d_name[] de tamaño no especificado, con NAME_MAX caracteres como mucho precediendo al carácter cero terminador. El empleo de otros campos perjudicará la transportabilidad de sus programas. En POSIX-2001 también aparece el campo ino_t d_ino como una extensión de XSI.
Los datos devueltos por readdir() pueden ser sobreescritos por llamadas posteriores a readdir() para el mismo flujo de directorio.
VALOR DEVUELTO¶
La función readdir() devuelve un puntero a una estructura dirent, o NULL si ocurre un error o se alcanza el fin-de-fichero.
ERRORES¶
- EBADF
- Descriptor de flujo de directorio inválido dir.
CONFORME A¶
SVID 3, POSIX, BSD 4.3
VÉASE TAMBIÉN¶
read(2), closedir(3), dirfd(3), opendir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)
25 Julio 1997 | Linux |